ping

Ping a device to test the connection between the switch and another network device. After you ping a device, the switch sends an Internet Control Message Protocol (ICMP) packet to the target device. If the device receives the packet, it sends a ping reply. After the switch receives the reply, displays a message that indicates traffic can reach the specified IP address. If the switch does not receive a reply, the message indicates the address is not responding.

Syntax

Note

Command parameters for ping vary depending on the parameter input order. All syntax possibilities are not listed. Use the CLI help to verify the syntax for available parameters during command contextual input.

ping WORD<0-256>
ping WORD<0-256> count <1-9999>
ping WORD<0-256> count <1-9999> mgmt [clip | oob | vlan]
ping WORD<0-256> -d
ping WORD<0-256> datasize <28-51200>
ping WORD<0-256> datasize <28-51200> mgmt [clip | oob | vlan]
ping WORD<0-256> grt
ping WORD<0-256> grt interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> grt interface tunnel <1-2000>
ping WORD<0-256> grt interface vlan <1-4059>
ping WORD<0-256> grt source WORD<1-256>
ping WORD<0-256> -I <1-60>
ping WORD<0-256> interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> interface tunnel <1-2000>
ping WORD<0-256> interface vlan <1-4059>
ping WORD<0-256> mgmt [clip | oob | vlan]
ping WORD<0-256> -s
ping WORD<0-256> -s mgmt [clip | oob | vlan]
ping WORD<0-256> scopeid <1-9999>
ping WORD<0-256> source WORD<1-256>
ping WORD<0-256> -t <1-120>
ping WORD<0-256> -t <1-120> mgmt [clip | oob | vlan]
ping WORD<0-256> vrf WORD<1-16>
ping WORD<0-256> vrf WORD<1-16> interface gigabitEthernet {slot/port[sub-port]}
ping WORD<0-256> vrf WORD<1-16> interface tunnel <1-2000>
ping WORD<0-256> vrf WORD<1-16> interface vlan <1-4059>
ping WORD<0-256> vrf WORD<1-16> source WORD<0-256>

Command Parameters

count <1-9999>

Specifies the number of times to ping(for IPV4/IPV6).

-d

Configures the ping debug mode. This variable detects local software failures (ping related threads creation or write to sending socket) and receiving issues (ICMP packet too short or wrong ICMP packet type) (for IPV4/IPV6).

datasize <28-51200>

Specifies the size of ping data sent in bytes. The datasize for IPv4 addresses is <28-9216>. The datasize for IPv6 addresses is <28-51200>. The default is 0.

grt

Specifies the ping is executed in Global Router (GRT) context.

-I <1-60>

Specifies the interval between transmissions (for IPV4/IPV6).

interface gigabitEthernet {slot/port[sub-port]} | tunnel <1-2000> | vlan <1-4059>

Specifies a specific outgoing interface to use by IP address. {slot/port[sub-port]} identifies a single slot and port. If your platform supports channelization, you must also specify the subport in the format slot/port/sub-port.

tunnel: Specifies the tunnel interface.

vlan: Specifies the VLAN ID in the range of 1 to 4059. By default, VLAN IDs 1 to 4059 are configurable and the system reserves VLAN IDs 4060 to 4094 for internal use. If you enable VRF scaling and SPBM mode, the system also reserves VLAN IDs 3500 to 3998. VLAN ID 1 is the default VLAN and you cannot create or delete VLAN ID 1.

mgmt

Ping a network connection using a zero source IP address and route lookup in the main table.

mgmt clip

Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.

mgmt oob

Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.

mgmt vlan

Ping a network connection using a Segmented Management Instance. If you do not use the mgmt parameter, the ping command uses the IP routing stack to initiate the ping request.

-s

Configures the continuous ping at the interval rate defined by the [-I] parameter (for IPV4/IPV6).

scopeid <1-9999>

Specifies the scope ID. <1-9999> specifies the circuit ID for IPv6.

source WORD<1-256>

Specifies an IP address that will be used as the source IP address in the packet header.

-t <1-120>

Specifies the no-answer timeout value in seconds (1-120) (for IPV4/IPV6).

vrf WORD<1-16>

Specifies the virtual routing and forwarding (VRF) name.

WORD <0-256>

Specifies the host name or IPv4 (a.b.c.d) or IPv6 (x:x:x:x:x:x:x:x) address (string length 0-256). Specifies the address to ping.

Default

None

Command Mode

User EXEC

Usage Guidelines

The -d, -I, interface, scopeid, source, and vrf parameters are not available if you specify the mgmt keyword.